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This document describes how to use ProtoGen for creating 
menus, linking and unlinking dialog boxes, generating final code 
in C++ and ANSI C, and developing Windows application 
prototypes. ProtoGen is itself a Windows application. It works 
with the ProtoView Screen Management Facility, with Windows 
alone, or in combination with both environments. Companion 
products ProtoView and the ProtoView DataTable offer a 
comprehensive screen management facility for Windows with 
sophisticated access to databases for browsing and updating. 


Intermediate output lets you construct, test, and modify an 
application prototype before expensive development on the final 
code is started. The final output of ProtoGen can be compiled and 
linked with Borlarid International’s ObjectWindows for C++. 
ProtoGen produces a fast, bug free, and modular source code that 
can be modified and extended easily. 


ProtoGen and this document are intended for use by beginning 
and experienced Windows programmers. To start using ProtoGen 
right away, see Chapter 2 for a step-by-step tutorial. See Chapter 5 
for more information about dialog boxes and how to link them to 
menu items. 


ProtoGen benefits 


ProtoGen helps numerous people involved in the development 
cycle of a Windows application. Typically, as the first step in 
application development, the end user tells the analyst how the 
application should work. Then, with ProtoGen, the analyst 
produces a user interface compatible with the other code that 
makes up a Windows application. Finally, using ProtoGen and 
either Borland’s Resource Workshop or ProtoView’s ViewPaint 
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(available separately), the user interface screens are changed as 
features are added and modified. 


Since ProtoGen is an effective design tool at various levels of 
application development, people with diverse skills can 
communicate their ideas in a visual and nontechnical manner. 
Because ProtoGen simplifies such tasks as developing menus and 
accelerator (shortcut) keys, linking dialog boxes to menus, and 
generating code for the framework of a Windows application, it 
frees the experienced developer to work on more critical aspects 
of the application. 


ProtoGen features 


ProtoGen offers the following features: 


a A graphically oriented user-interface design tool for quickly 
designing menus for Windows applications. 

m A code generator compatible with ANSI C and Borland’s 
ObjectWindows for C++ that integrates many levels of dialog 
boxes, created with another software package, into your 
applications. 

w An application layout and prototyping tool. 


m A tester for trying out the interface before finalizing code. 


Hardware and software requirements 


——  _______ 


ProtoGen minimum requirements are Windows Version 3.0 or 
later in Standard or 386 Enhanced mode, at least 2.0 megabytes of 
RAM, and 3 MB of free space on the hard disk. A mouse or other 
pointing device is optional. 


To create executable versions of your prototypes using ANSI C, 
you need the Borland C++ version 3.0 compiler or another 
compiler capable of compiling for Windows. 


To create executable versions of your prototypes using C++, you 
need the Borland C++ version 3.0 & Application Frameworks, 
which includes ObjectWindows. 
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Overview 


Geiting started 


Chapter 1, Getting started 


Application development under Windows is often complex, 
difficult, and intimidating, even for experienced C and C++ 
programmers. The following section tells you how to use Proto- 
Gen’s prototyping capability to make the creation of Windows 
applications easy—as easy as using Windows applications. 
Prototyping lets a developer put together a working demon- 
stration of an application, show it to the user, make needed 
modifications, show it again, and repeat the process until the 
prototype becomes the working program. 


The following list describes the basic steps involved in using 
ProtoGen: 


1. Tell ProtoGen the location of the application header file. See 
Chapter 3. 


2. Create a menu for your application from scratch or edit an 
existing menu contained in an .RC or .MNU file. Design 
menus with submenus or popups, grayed or disabled items, 
accelerator keys, separators, and menu bar breaks in any 
combination and order. ProtoGen lets you move, change, add, 
insert, or remove menu items easily. 


3. Link dialog boxes contained in existing .DLG files to menu 


items. (The .DLG files are created using either the Windows 
SDK, ProtoView’s ViewPaint, Borland’s Resource Workshop, or 


similar software. See Chapter 5 for brief instructions on 
creating .DLG files with Resource Workshop. 


4. Specify the icon and colors of the top level window. 
5. Specify a caption for the top level window. 


6. Attach subdialog windows to dialog buttons that don’t 
already have a dialog box attached. 


7. Change the attributes of the existing, attached dialog box, by 
simply pressing F2 or right clicking the mouse when that 
dialog box has the focus. 


8. Specify the main window of the application as a dialog box or 
view window. When you make the main window a dialog 
box, ProtoGen loads and displays the dialog box resource 
while the application is prototyped. Subdialog boxes are 
attached to controls on the main window just as if they were 
dialog boxes. 


9. During the application design and prototyping stage, 
interactively test the current screen flow before generating 
code. The prototype can be shown to end users to get 
additional feedback and comments concerning the design and 
flow of the application. 


10. Generate C or C++ code ready to compile and execute for the 
entire interface, including the header file, resource file, module 
definition file, make file, and linker response file. Any 
previous versions of modules containing custom code are 
regenerated with the added code intact. The code generator 
produces files for the main window and each of the dialog 
boxes contained in the application. 
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. Finally, write the C or C++ code to create the functionality 
portion of your application, and connect it to the ProtoGen- 
generated code. 


Installing ProtoGen 


Before installing ProtoGen, read the licensing agreement included 
in the product package, and make a backup copy of the installa- 
tion disk. Perform the following steps to install ProtoGen: 


1. Insert the disk into either drive A or B. 
2. Make either drive A or B the current drive. 
3. Enter the following command: win install 
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Before attempting to edit the 
AUTOEXEC.BAT, click on the 
edit box to turn off text 
highlighting. Use CTRL ENTER 
instead of ENTER for multiple 
lines. 


. The installation dialog box is displayed with install and cancel 


buttons. 


. Click Install. 
. Enter the drive and path to install ProtoGen. 


After you've loaded the disk contents, a dialog box shows the 
current AUTOEXEC.BAT file and proposed changes. 


. Edit the box with the proposed changes or click OK to update 


the AUTOEXEC.BAT file. Select Cancel to leave the file 
unchanged. 


The PATH variable is updated to include the location of Proto- 
Gen. Remember to run the AUTOEXEC.BAT for the new path 
setting to take effect. 


8. Add the program icon. 


Starting ProtoGen 


Double-click on the ProtoGen icon, located in a program group of 
the Windows Program Manager. The ProtoGen Application 
Generator screen is displayed. 


Figure 1.1 


"ProtoGen C++ Application Generator a [a] 


5 =——— 
Application Generator File Edit Application Tools Help 


screen 


General 


Many ProtoGen operations are familiar to Windows users. 
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Mnemonics 


Accelerators 


Table 1.1 
Accelerator keys 


Other features 


A mnemonic is an underlined letter in the name of a menu or 
menu item. For example, “F” is the mnemonic for the File menu 
on the ProtoGen Application Generator screen. See the “ProtoGen 
main menu bar” section, which shows mnemonics for menu items 
on ProtoGen’s main menu. 


While using ProtoGen in test or prototype mode, the main menu 
mnemonics aren’t available until you press F4 to switch out of test 
or prototype mode. 


Typing the mnemonic selects the menu just as if you clicked on it. 


Accelerator keys are actually key sequences that let you quickly 
access menu functions. Instead of clicking on a menu and clicking 
on a menu item, you type a key sequence from the main window. 


ProtoGen has the following accelerator keys: 


Menu Key sequence 
Main Menu: 

File |New Ctrl F2 
File | Open Ctrl F3 
File | Save Ctrl F4 
File | Exit Alt F4 
Edit | Design Menu CtrlM 
Application | Test Ctrl T 
Application | Generate Ctrl G 
Menu Designer: 

File |New Ctrl F2 
File | Open Ctrl F3 
File | Save Ctrl F4 
Edit | Cut Shift Del 
Edit | Copy Ctrl Ins 
Edit | Paste Shift Ins 
Menu! Add Menu Item Ctrl | 
Menu | Add Item to Action Bar Ctrl B 


Grayed-out (dimmed) menu items and buttons are unavailable in 
the current mode. 


Clicking on the upper left corner of ProtoGen’s windows displays 
the System menu. See your Windows documentation for 
information on the system menu and other basic Windows 
information, such as how to use maximize and minimize buttons. 
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Tne ProtoGen 
Application 
Generator 


This document describes only one way, the mouse method, of 
working with ProtoGen; however, ProtoGen menus and dialog 
boxes offer several methods of operation: keyboard shortcuts, 
accelerator keys, or mouse point-and-click methods. For example, 
open popup menus by typing the mnemonic in the menu’s name 
or by clicking on the menu name. Select menu items by clicking 
on them or typing the mnemonic in the menu item’s name. 


The accelerator key sequence, if there is one, is displayed to the 
right of the menu item. Dialog boxes have buttons usually labeled 
OK and CANCEL. After entering data into the dialog box 
window, click on OK or press Enter. The CANCEL button escapes 
from the dialog box without changing anything. 


The ProtoGen Application Generator screen, shown in the 
previous figure, contains two menu bars: the upper main menu 
bar with File, Edit, Application, Tools, and Help popup menus, 
and the lower Application Prototype title bar, which initially 
displays “Application Caption.” 


ProtoGen main menu bar 
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The following figure shows the main menu bar and its associated 
menus. The accelerator keys (shown on the right-hand side of the 
menu item) are for accessing ProtoGen functions by the shortcut 
method. The menus are discussed in detail in subsequent sections. 


Application 


Design Menu... Define Tool... 
Main Window Dialog... 

Application Icon... 

Window Caption... 

Window Colors... 


Remove Window Colors 
Generate... Ctr1+G 
Execute... 


Resource... Contents 
Source... Keyboard 
Header... Using Help 
Make... 
Definition... 
Other... 


If you opened files in 
ProtoGen previously, the 
names of the last four .PVA 
files are displayed on the File 
menu. 


About ProtoGen... 


Ctr1+F2 
Open... Ctr1+F3 
Ctrl+F4 


Working Directory... 
Header File... 


Exit Alt+F4 
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Tutorial 


This chapter presents an example of how to perform the critical 
steps in creating an application prototype with ProtoGen. You 
open an existing .MNU file, edit it, observe changes on the 
prototype menu, and link dialog boxes to the prototype menu. 


Opening a .MNU file 


Assuming you've just installed ProtoGen and have the Windows 
Program Manager displayed, perform the following steps to open 
the .MNU file: 


1. Double-click on the ProtoGen icon to invoke ProtoGen. 
2. Select File | New from the following ProtoGen main menu. 
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ProtoGen C++ Application Generator _ 


Figure 2.1 SS gr lication Tools Hel «| 
‘1 File pplication Tools Help 
etal New cult 
Open... Ctrl+F3 
Save Ctrl+F4 
SaveAs... 
Working Directory... 
Header File... 
Exit AlttF4 
Selecting File | New in the last step displays the following 
screen: 
Figure 22 ~ ProtoGen - C:A\PROTOGEN(untitled) a Be 
r 4 A File Edit Application Tools Help 
tila 


Design Menu 


3. Click Design Menu. The Menu Designer screen is displayed. 


4, Select File |Open from the Menu Designer menu bar to display 
the following screen: 
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Figure 2.3 
Open Menu Resource File 
screen 


Figure 2.4 
Menu Designer 
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File Edit Menu 


= Open Menu Resource File 
File Name: 


Directories: 
c:\protogen 
Ges 
B> protogen 

© examples 


List Files of Type: Drives: 


. Select the EXAMPLES directory from the Directories list box, 


and click OK. 


. Select DEMO.MNU from the File Name list box, and click OK. 


You're asked if you want to copy the menu resource file to the 
working directory. 


. Click OK. The Menu Designer screen list box shows the 


contents of DEMO.MNU: 


Menu Designer - 


ge Insert Cascade 


L) 4 
PONT 


Accelerator Keys 
sy 


@ or 


&Benefits 
1 &History 
&Help » 

&UsingHelp 


SS Se 


1] 


Changing a menu item 


Look at File, Entry, and Help on the prototype bar of the menu 
designer. The “E” in Entry and “H” in Help are underlined to 
indicate the mnemonic, but File has no mnemonic. The File menu 
contains New, Open, Save, SaveAs, and Exit items and none have 
mnemonic indicators. The Entry and Help menus, on the other 
hand, have mnemonics indicated for the first letter of each of their 
menu items. For example, Benefits on the Entry menu. 


Pull down each menu, and inspect the menu items on it. Notice 
that menu items in the list box contain ampersands before the 
mnemonic letters. 


The next few steps add a mnemonic, “F” to the File menu name 
by inserting an ampersand before File >> on the first line of 
DEMO.MNU in the list box: 


1. Focus on the single-line entry window above the list box, 
which contains the line you want to edit; in this case it’s File. If 
the single-line entry window doesn’t contain the line you want 
to edit, focus on it in the list box, and move to the edit box. 


2. Move the focus to the beginning of the word and type an 
ampersand. 


3. Press Enter. 


The list box and prototype menu bar are updated with an 
ampersand and a mnemonic, respectively. 

4, Select File | New from the prototype menu. New is displayed 
in the single-line entry window. 


5. Repeat steps 1-3 to add the mnemonic to New. 


Add mnemonics to Open, Save, SaveAs, and Exit menu items. 
The ampersand goes in front of the first letter for most menu 
items. The ampersand should be placed in front of the “A” in 
SaveAs and in front of the “x” in Exit. 


Inserting menu items 


Add a popup menu called Edit between the Entry and Help 
menus by performing the following steps: 


1. Select the line containing “&Help >>” from the list box. 
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2. Press Enter. 
3. Type “&Edit”. 
4. Click the Insert button. 


An Edit menu is inserted in between Entry and Help menus 
on the prototype menu bar, and “&Edit” is inserted before 
“&Help” in the list box. 


Adding a cascade 


Add a cascaded menu to the Edit menu by clicking the Cascade 
button. Menu items with template names Item1, Item2, and Item3 
are added to the list box and to the prototype Edit menu. 


Change the template names to Employee, Benefits, and Medical 
by selecting the template text to edit from the list box and moving 
to the single-line entry box edit the names. 


Adding a separator 


Add a separator between the SaveAs and Exit items on the File 
menu by selecting Exit and clicking the Separator button. 


“SEPARATOR” appears in the list box, as shown in the following 
figure. 
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Figure2.5 [=| Menu Designer - C:\PROTOGEN(DEMO.MNU)(demo) 
Separator File Edit Menu 


Accelerator Keys 


® None © cul 
© Shift 


ny None 
S Backspace 


&Benefits 
Leet: &History 
SedEdit » 


Inspect the File menu on the prototype bar to see the effect of 
adding the separator. 


Adding an accelerator 


Perform the following steps to add the menu accelerator, ALT+S, to 
the Save item on the File menu. 


1. Select File | Save from the prototype menu. 
2. Select Alt in the Accelerator Keys window. 
3. Select S in the Accelerator Keys scroll box. 
4, Press Enter. 


Inspect the File menu on the prototype menu bar and verify that 
Alt+S is displayed adjacent to Save. 


Linking dialog boxes 


The following steps link dialog boxes to menu items displayed on 
the main ProtoGen screen below “Application Caption”: 
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Figure 2.6 
File menu 


Figure 2.7 
File menu 
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File | Done from the Menu Designer menu, not from the 
prototype menu. 

The ProtoGen main window is displayed again, but now 
instead of “Design Menu” the menu you created (File Entry 
Edit Help) from the DEMO.MNU template appears on the 
prototype menu bar below Application Caption. 


. Select File | New from your prototype menu, which is the 


lower menu on the following figure: 


ProtoGen - C:\PROTOGEN(demo.pva) : Fe 


=| 
File Edit Application Tools Help 


Application Caption 


File Entry Edit Help 


The Add Application Dialog screen is displayed with a scroll 


1. Exit the menu design mode by selecting File | Save followed by 


list of drives and directories in the bottom, left-hand window. 


= Add Application Dialog ; 


Current Dialog: 


OK 


Dialog Mode 


Files in: ¢:\protogen 


Dialog Files Dialogs Contained 
benefits. dig 
bkground.dlg 
demo.dig 
medical.dlg 
[.] 


. Go to the directory, EXAMPLES by double-clicking on 


[examples]. 


. Select DEMO.DLG. 
. Press Enter or click on the Open File button 


DLG resources contained in DEMO.DLG are displayed in the 
bottom, right-hand window. 


. Select the dialog box to be attached; in this case 


DLG_FILENEW, from the Dialogs Contained list. 


7. Press Enter. 


Verifying the link 


. Click OK to the question, “Copy dialog resource file to 


Working Directory?” 


The selected dialog box, labeled “New”, is attached to the 
File | New menu item. 


To verify the link to the dialog box, select File | New. The dialog 
box “New” displayed. 


To close the “New” dialog box, double click on the client area of 
the New dialog box. Alternatively, this particular dialog box 
could be closed by selecting Close from the New’s control-menu 
box, but some dialog boxes won't offer this option. 


Attaching subdialog boxes 


Dialog boxes attached to other dialog boxes are called subdialog 
boxes. Perform the following steps to attach a subdialog box to 
the “New” dialog box on File | New from the prototype menu. 


Le 


Select File | New. 
The “New” dialog box is displayed. 


. Attach a subdialog box to the Okay button of “New” by 


clicking on the Okay button. 
The Add Application Dialog screen is displayed. 


. Go to the directory, EXAMPLES, by double-clicking on 


[examples]. 


. Select DEMO.DLG. 
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Verifying links 


. Press Enter or click the Open File button. 
. Select DLG_SETUP from the Dialogs Contained window. 
. Click OK. 


The Add Application Dialog screen disappears, and the 
“Setup” screen is in view. 


. Double-click on the client area of the “Setup” screen to escape, 


getting back to the parent (“New”) dialog box. 


. Double-click on the client area of the “New” screen to get back 


to the main ProtoGen window. 


Verify that the subdialog box was linked correctly by performing 
the following steps: 


1. 


Select File | New, and click the Okay button on the “New” 
(parent) dialog box. 


The subdialog box called “Setup” is displayed. 


. Double-click on the client area of the subdialog box to get back 


to the parent dialog box. 


. Double-click on the client area of the parent dialog box to get 


back to ProtoGen’s main window. 


Removing dialog boxes 
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To unlink the subdialog box, “Setup”, from the application, 
perform the following steps: 


de 


Go to the ProtoGen main window, select Edit | Employee to 
display the “New” dialog box, and click Okay to display the 
subdialog box, “Setup”. 


. Click the right mouse button or press F2. 


The Edit Application Dialog screen is displayed. 


. Click the Remove button. 
. Click the Yes button when asked if you want to delete the 


dialog box. 


The subdialog box is unlinked and the parent dialog box is in 
view again. 


5. Double-click on the client area of the parent dialog box to 
escape to ProtoGen’s main menu. 


Changing modality 


Change the modality of a dialog box by repeating steps in the 
previous section to get the Edit Application Dialog screen. When 
the Edit Application Dialog screen is displayed, select modal or 
modeless. 


Naming and coloring the application 


Neen eee 


See Chapter 4 for instructions on performing the simple 
operations involved in naming and coloring an application and 
selecting an icon for it. 


18 ProtoGen User’s Guide 


File menu 


This chapter describes selections on the File menu, which create 
or access application prototype files. 


New Ctrl+F2 
Open... Ctr1+F3 
Save Ctr1+F4 
Save As... 


Working Directory... 
Header File... 


Exit Alt+F4 


File Menu selections 


New 
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The File Menu lets you open and close .PVA files (defined later), 
save prototype menu data, tell ProtoGen where to find files, and 
exit from ProtoGen. The following sections describe each menu 
selection in detail. 


File | New begins a new application prototype as opposed to a 
prototype created previously. If any files are open in ProtoGen 
you'll be reminded to save them. 


Open 


Figure 3.1 


ProtoGen Open dialog box 
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Save 


File | Open accesses existing application prototype template files, 
.PVA files. The following screen is displayed: 


= ; Open ProtoGen Template File 


File Name: Directories: 
demo.pva Bes 

& protogen 

(©) examples 


List Files of Type: Drives: 


[ProtoGen Files(*.PVA) [3] [= e 


Click in the Drives scroll box to access the drive you want. Click 
in the Directories box followed by OK to access the directory you 
want. Click in the file box to access the file you want to open, or 
type the File Name in the window above the list box. 


Upon opening an application (.PVA file), ProtoGen displays 
information from the menu template (.MNU file) or the resource 
script (.RC file) associated with the .PVA file, and creates the 
prototype menu. 


A .PVA file is like a table of contents. It doesn’t contain any actual 
data. It gives ProtoGen the following information: 
m the type of application to generate (C or C++) 


m the names of the header (.H), resource (.RC), module definition 
(.DEF), make or project (MAK), and icon (.ICO) files. 


m the name of the caption of the prototype 
m the color of the client area of the prototype 
w additional library directories 


File | Save stores application prototype information including 
form, attributes, and the menu description file (MNU or .RC file) 
to a disk file in the working directory. For new applications, 
ProtoGen prompts you for a file name before performing the 
operation. Enter a file name without an extension. File | Save saves 
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SaveAs 


Figure 3.2 
ProtoGen SaveAs dialog box 


WorkingDirectory 
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the prototype information to the .PVA file and saves the .MNU 
file according to the application’s name. See Chapter 4 for more 
information about .MNU and .RC files. 


File | SaveAs stores application prototype information under a 
different name, and allows you to change the file names of both 
the .PVA and the .RC files. See the previous instructions for File | 
New. File | SaveAs works similarly. Using SaveAs with template 
menus (.MNU files) lets you keep the template file intact. 
ProtoGen sets the working directory according to the directory 
specified with the SaveAs command is used. 


REFS Se SSO ee, 
File Name: Directories: 
ipyva c:\protogen - 

: 


Bes 
& protogen 


© examples 


Save File as Type: Drives: 


ProtoGen Files(*.PV¥A) +] 


File | WorkingDirectory specifies the file directory where ProtoGen 
writes and overwrites the PVA and supported files. To change 
the working directory, double-click on the directory or drive 
letter, and click OK. By default, the current directory is the 
working directory. Selecting an application in another directory 
changes the working directory to that directory. 


To prevent overwriting files inadvertently, check which directory 
you're in. Look at either the Application Caption section of Proto- 
Gen’s main menu bar or the Current Directory window in the 
WorkingDirectory dialog box. Both display the name of the 
working directory unless you've just invoked ProtoGen and 
haven’t opened a file yet. 
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Figure 3.3 
ProtoGen Working directory 
dialog box 


Header File 


Figure 3.4 
ProtoGen Header File Dialog 
box 


Important: ProtoGen can‘t 
generate code without 
knowing the location of the 
header file. 


The Open button on the 
Open Disk file dialog opens a 
file, but won’t automatically 
invoke an editor. 
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= Set Working Directory 


Current Directory 


c:\protogen 


Directories 


File | Header File displays the following dialog box, which 
performs several functions. 


= Select #define Header File 


The Select button brings up the Open Disk file dialog box that lets 
you select a .H file in any directory. You can put the file name in 
the File name input box or change to another directory using the 
directory box. Next you can select the file using the Files list box. 


The header file contains #define preprocessor directives used in 
generating the application, like those in the following example: - 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


Id Splash 102 

id help 210 

ID ScribbleDirectory 219 
id TextDirectory 220 

id GraphicDirectory 221 
id FList 101 

id DList 102 

id Text 205 


id Scribble 206 
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Exit 


Figure 3.5 
File menu 


A .PVA file can be selected 
from the menu with the 
mouse or by typing the 

underlined numeral. 
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#define id Graph 207 
#define id FName 100 


The Edit button on the Header File Dialog box displays the .H file 
in an editor, similar to the NotePad. It has popup menus for 
saving the new file and for cutting and pasting changes to the .H 
file, which must be less than 32K. 


File | Exit shuts down ProtoGen, asking you to save work in 
progress and saving current environment settings, such as 
workfile name, compiler model and size, and code generation 
options, and updating the .PVA and .MNU files. 


The first time you work with ProtoGen, Exit is the last choice on 
the File menu, but in subsequent sessions ProtoGen displays the 
file names of the last four application prototypes created at the 
bottom of the menu. 


New Ctrl+F2 
Open... Ctrl+F3 
Save Ctrl+F4 
SavedAs... 


Working Directory... 

Header File... 

Exit AlttF4 
1 C\PROTOGEN\demo.pva 
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Figure 4.1 
Edit menu 


Design Menu 


Edit menu 


This chapter describes each entry on the Edit menu in more detail. 
The Edit menu accesses ProtoGen’s most important functions. The 
following figure shows items on the Edit menu. 


ProtoGen C++ Application Generator 
iW) Application Tools Help 
Design Menu... Ctrl+M 
Main Window Dialog... 
Application Icon... 
Window Caption... 
Window Colors... 
Remove Window Colors 


Resource... 
Source... 
Header... 
Make... 
Definition... 
Other... 


Edit Resources 
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The Design Menu displays controls for creating the prototype 
menu. From this menu, the Design Menu functions are invoked, 
and the following Menu Designer controls are displayed: 
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Figure 4.2 
Application Generator 


Design Menu appears in the 
bar under the Application 
Caption. 


ProtoGen= C:\PROTOGEN[untitled) 
File Edit Application Tools Help 


Application Caption 


Design Menu 


After selecting File | New, the title bar of the Application 
Generator screen displays “Application Caption” in the center of 
the bar. 


To alter and update the application prototype menu with the 
ProtoGen Menu Designer, invoke the Menu Designer in one of the 
following ways: 


aw After selecting File | New, click on “Design Menu” in the menu 
bar of the Application Generator, which is the lowest menu bar 
on the screen. 


Select Design Menu from the Edit menu on the main menu. 


The following Menu Designer window is displayed: 
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Figure 4,3 
Menu Designer screen 


In this example, the 
prototype menu contains 
File, Entry, and Help menus. 
The single-line entry box is 
located above the list box in 
the lower central portion of 
the menu. 
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SS "Menu Designer - C:\PROTOGEN(DEMO.MNU){demo) 
File Edit Menu_ 


Change ae | | Sl 


GaneeeaneeniRE ORI 


&Benefits 
&History 
elp » 
&UsingHelp 


Alt+F6 or the mouse toggles between the Menu Designer menu bar 
and the top-level menu bar. 


The Menu Designer lets you create a specialized resource script, 
which is stored in a .MNU file. The Menu Designer creates 
identifiers and connects accelerator keys to menu items. See 
Chapter 1 for more information on Accelerator keys. 


The following steps briefly describe how to design a menu from 
scratch: 


1. Start the Menu Designer, using one of the following methods: 


m Select File | New followed by Edit | Design from the 
ProtoGen main menu bar (ProtoGen names the menu file 
the same as the .PVA file, but with a .MNU extension). 


@ Select File | New from the Menu Designer menu, and enter a 
new menu resource name. 


@ Select File |Open and select from a list of the .MNU files in 
the working directory or select a .RC file. To see a list of .RC 
files in the working directory, enter *.rc in the File Name 
window. 
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.MNU files 


.RC file 


2. Make a new menu using the controls on the Edit and Menu 
menus, and using the other Menu Designer controls, which 
are described later. 


3. Click Done below the list box. 


4. Select File | Save, and enter the name of the application if 
required. 


i 


Menu template files are ASCII text files with the extension .MNU. 
Because they are reusable in different applications, the template 
files free you from redesigning the menu each time. Like resource 
script (.RC files), .MNU files contain the following data: 


ma menu resource—an RC script that describes the structure of a 
menu 


man optional accelerator table—shortcut definitions for 
Accelerator keys. 


As you edit a .RC file, MNU template file, or create a file from 
scratch, the display in the Menu Designer list box represents the 
contents of the file, while the Menu Designer menu bar shows the 
prototype menu. 


To navigate from the list box in the center of the screen to the 
menu bar and vice versa, click on menu items in either area. 
When you highlight a line in one area, the line is addressed in the 
other area automatically. Associated Accelerator keys are 
highlighted as well as menu states. Experiment and you'll quickly 
appreciate how informative the Menu Designer is. 


a 


The following example shows how a .RC file appears in the list 
box of the Menu Designer: 


&File >> 
&Load 
&Save 
&Print 
SEPARATOR 
GExit 

&Setup >> 
&Games 
&Stats 
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Top menu bar 


File 


Figure 4.4 
Open template file 


Click on the drive and file 
you want, or type the name 
of the file in the window 
under File Name. 
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&Week >> 
Next 
Prev 


The top menu bar of the Menu Designer screen has menus located 
above the control buttons offering the following selections: 


Ctr1+Del 
Copy Ctri+Ins 
ShifttIns 


New Ctri+2 


Open... Ctr1+3 
Save Ctri+4 
SaveAs... 


Add Menu Item Ctri+l 
Add Menu Item to Action Bar Ctr1+B 


Select File | New to start a new application. A dialog with an input 
box is displayed. Enter the resource name, which doesn’t have to 
be the same as the resource file name. The resource name should 
be an acceptable name for a .MNU file. 


Select File | Open to open an existing .MNU or .RC file. The 
following dialog box is displayed: 


Open Menu Resource File 


File Name: Directories: 
[mnu c:\protogen 
demo.mnu Ges 


& protogen 
© examples 


List Files of Type: 


Menu Files(*.MNU) | 


See the description of ProtoGen’s main menu File | Open in 
Chapter 3. It works the same way. 


Click File | Save to save a file under its current name, or click 
SaveAs to rename the file using the following dialog box: 


29 


Figure 4.5 
Save As 


Click on the drive and file 


name you want, or type the 


new file name in the window 
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under File Name. 


Edit 


Important 


Menu 


File Name: Directories: 
ipyal c:\protogen 
Ben 
& protogen 


(2 examples 


Save File as Type: Drives: 


ProtoGen Files(*.PVA) 2] 


See the description of ProtoGen’s main menu File | Save and File | 
SaveAs in Chapter 3. They work the same way here. 


Click on File | Done to exit the Menu Designer. 


The Edit menu lets you cut, copy, and paste one line at a time 
from the list box, which is the large box in the center of the Menu 
Designer. The cut, copy, and paste operations work as you’d 
expect. The Windows Clipboard holds data for the cut and paste 
operations. 


m Cut cuts the highlighted line from the list box, and puts it in the 
Clipboard. 


™ Copy puts a copy of the highlighted line into the Clipboard. 


Paste inserts the contents of the Clipboard at the current 
position in the list box. 


You can’t copy and paste popup or cascaded menus in their 
entirety. Attempting to cut cascaded menus causes ProtoGen to 
display a warning message. 


Cutting the last menu item in a popup changes the popup to a 
menu item. 


Menu contains two selections that help you design menu 
templates for storage in .MNU files. The selections on Menu, Add 
Menu Item and Add Menu Item To Action Bar, insert canned, 
template text (“Menultem” and “Popup”) into the Menu Designer 
list box. These selections help you position the canned text at the 
end of a menu-level or menu bar during creation of a menu 
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Add Menu Item 
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template. You change the canned text to actual menu and menu 
item names when you design the actual application menu from 
the template. 


Add Menu Item appends the text “Menultem” to the end of 
whichever menu section is focused in the list box. The Menu 
Designer Append button performs like Add Menu Item, except 
the button puts text you type in the single-line entry box at the 
end of the focused menu section of the list box. 


For example, assume the Menu Designer list box contains an .RC 
file represented in the following way: 


&File >> 
&Load 
&Save 
&Print 
SEPARATOR 
E&xit 

&Setup >> 
&Games 
&Stats 
&Week >> | 

Next 
Prev ( 

&Pick ! 
&Winners 

&Display >> 
&Picks 
&Ratings 
&Help >> 


Append “Menultem” to the &Setup menu by focusing on | 
&Games, &Stats, or &Week. Select Menu! Add Menu Item. 


ProtoGen inserts “Menultem’” in the following location: 


&File >> 
&Load 
&Save | 
&Print 
SEPARATOR 
B&xit 

&Setup >> 
&Games 
&Stats 
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Ks 


Add Menu Item to 
Action Bar 


Cascading menus are often 
called “popup” menus, but 
use of the text “Popup” by 
Add Menu Item doesn’t 
mean the menu is 
cascading. 


Menu Designer 
buttons 
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&Week >> 
Next 
Prev 
MenuItem 
&Pick 
&Winners 
&Display >> 
&Picks 
&Ratings 
&Help >> 


The Add Menu Item to Action Bar selection on Menu appends a 
main menu called “Popup” to the end of the data displayed in the 
list box. “Popup” appears in the rightmost position on the Menu 
Designer's prototype menu above the list box. This feature is 
handy when you want to add a new menu and ensure it’s placed 
at the end of the prototype menu bar. Later, use the Cascade 
button on the menu labeled “Popup” to make it cascading. 


The Cut, Copy, and Paste buttons behave exactly the same as the 
equivalent menu items in the Edit menu. 


m Append adds .RC or .MNU entries from the single-line entry 
field above the listbox to the end of the current level. 


a Insert adds a menu item just previous to the currently 
highlighted menu item in the listbox. The name of the menu 
item is determined by the contents of the single-line entry field 
above the listbox. 


a Change puts the contents of the single-line entry field in the 
highlighted location of listbox. 


mw Cascade converts a menu item into a cascading menu item, 
commonly called a popup. This button is ineffective if used 
when highlighting a menu that’s already cascaded. 


If fewer than three menu items are needed, it’s easy to delete 
one. If more than three menu items are needed, select a menu 
item within a popup menu, and click the Append button to add 
them. Use the Cut button to delete extra menu items. Cascaded 
menu items serve as headings for child menus. A cascaded 
menu has an arrow on the right side pointing to the right. The 
arrow indicates that selecting the item brings up another menu. 
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Items in a cascaded menu are usually closely related 
functionally. 


Cascaded menu items can’t be cut and pasted with the 
Clipboard facility. 


mw Separator adds the word “SEPARATOR” above the focused 
menu item in the list box, as shown in the following figure: 


Menu Designer - C:\PROTOGEN(DEMO.MNU)(demo} 


Figure 4.6 ae 
Separator function Edit Menu_ 
Change sert Cascade 
oo SS LANA AEI ISS SAREE INANE MOINS 
Accelerator Keys | Item State 
@® None © ctl | SF i ; @ Active 
Oatt © Shift | 
Menu Options 
&Benefits © No Break 
History 2| © Menu bar break 
Edit » 
E 
Separators can’t be added to cascaded menu items. 
When you popup the prototype menu, a separator line is 
displayed at the indicated location. 
Examples 


For example, assume you've created a popup menu, called File, 
with menu items Open, Save, and Exit. Begin adding ampersands 
by selecting the File popup menu in the Menu Designer list box. 


Change example Double-click on the list box or press ENTER. Add the ampersand 
character in front of the F in the word File. Press ENTER and the 
ampersand appears in the list box. Repeat this process for Open, 
Save, and Exit by clicking on each item in turn and editing its text 
in the edit box. 
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Insert example 


Cascade example 


Separator example 


Item State 


Text entered in the single-line 
entry field takes effect when 
you press the Change button 
or ENTER, whereas the option 
selected for the menu item is 
effective immediately. 
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Assuming you have two popups, File and Help, created and 
displayed on the prototype menu bar, insert a popup called 
“Edit” between them. Select the Help menu item from the list box 
and press Enter. Change “Help” to “Edit” and click the Insert 
button to insert “Edit” in front of the Help. 


To create a cascaded menu or popup menu, select the menu item 
to be cascaded from the list box. Click the Cascade button to insert 
three menu items under the focused menu. The Menu Designer 
names the menu items Item1, Item2, and Item3. Rename the three 
menu items to suit the application, for example, rename Item1, 
Employee and place the ampersand character in front of the letter 
E. Change Item2 into the word Department placing the 
ampersand mnemonic character in front of the letter D. Change 
Item3 into the word Location placing the ampersand mnemonic 
character in front of the letter L. Inspect the menu items under the 
popups in the main action bar to verify the changes. 


To add a menu separator to a popup menu, select the menu item 
that you want to follow the separator. Click the Separator button. 
The word “SEPARATOR” appears immediately below the 
selected menu item and a separating line is displayed at the 
appropriate place on the prototype menu. 


The Item State refers to the initial state of the menu item that can 
be changed by ProtoGen. The Item State controls to the right of 
the Menu Designer list box, Active, Grayed, and Checked, are 
located on the right side of the list box. The default item state is 
active, which means that the focused menu item invokes a 
function or dialog box. Select a radio button to make menu items 
grayed or checked. Grayed items don’t invoke a function or 
dialog box. Checked items are displayed on the menu with a 
check mark and indicate an “on” state. 
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Menu Options 


Accelerator keys 


Exiting Menu 
Design 
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The Menu Options—No break, Menu bar break, and Menu 
break—control space on the left-hand side of the menus items on 
the main menu bar. Menu bar break displays the focused menu 
item with a breaking line on the left-hand side of the menu, while 
Menu break displays the extra space without the line. 


Menu accelerator keys let the user quickly make menu choices 
through the keyboard rather than the mouse. Accelerator keys for 
the most frequently performed operations in an application 
should be easy-to-remember and easy-to-type. 


Accelerator keys consist of one or two keys that select a menu 
item. Accelerators can’t be added to popup or cascaded menus, 
and they don’t work in test mode. A menu accelerator can be 
associated with a menu item by performing the following steps: 


1. Select the menu item from either the list box or from the 
popup on the prototype menu bar. 

2. Choose one of the radio buttons (None, Ctrl, Alt, or Shift) to 
the left of the menu list box. 

3. Select the second key, Backspace, Del, Ins, or one of the other 
keys listed in the scroll box below the Accelerator Keys. 

4, Inspect the popup menu on the prototype menu that contains 
the menu item selected in step 1. Seeing the names of the 
accelerator keys on the prototype menu verifies that you set 
them correctly. 


Select File | Done from the menu bar to exit the Menu Designer. 
The ProtoGen main window is displayed. When you exit the 
Menu Designer, the following screen is redisplayed: 
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CCA) == ProtoGen-CAPROTOGEN(untitled) we 
Application Generator 
Application Caption 


Design Menu 


Click on the Design Menu or 
whatever you’ve named 
your menu, which appears 
under Application Caption, 
to bring up the controls for 
linking dialog boxes to the 
menu. 


Attach dialog boxes to the menu items or attach a dialog box to 
the main window as described in the next chapter. 


Main Window Dialog 


The Edit | Main Window Dialog menu item lets you select a pre- 
existing dialog resource for display in the client area of your 
application and control the flow of screens in your Windows 
application. Dialog boxes and data entry screens can be linked to 
menu items and to buttons and bitmaps on other windows easily. 


See the next chapter for instructions on how to link dialog boxes 
to menus or to the application’s main window. 


Application Icon 


The application icon, caption, and background color of the 
application’s main window can be set either before or after using 
the Menu Designer. 


To select an icon for the application, select Edit | Application Icon 
from the ProtoGen main menu. The following dialog box is 
displayed: 
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Figure 4.8 
Select Application Icon 


=> Select Application Icon 
Icon File Name: |PROTOGEN.ICO 


Click the Select button. ProtoGen displays a list of icons. If you 
select an icon from another directory, ProtoGen asks if you want 
the icon file to be copied to the working directory and made 
available to the resource compiler. The application’s icon is 
displayed when the compiled application is minimized. ProtoGen 
won't display the icon in test mode or while the application is 
being prototyped. 


Window Caption 


Figure 4.9 
Edit Application Window 
Caption 


Window Colors 


To set the application window caption, choose Edit | Window 
Caption from the main menu and enter the caption text in the 
following dialog box: 


= Edit Application Window Caption 


Main Window Caption Text 


Employee Tracking System 


Click the OK button to see the caption displayed. An alternate 
way of editing the application caption is to click on the caption 
bar to display the Edit Application Window Caption dialog box. 
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To select the background color of the application’s main window, 
choose Edit | Windows Colors from the main menu. (If you’re in 
Edit | Main Window Dialog mode, exit to select background 
colors.) The following dialog box lets you choose one of 64 
predefined colors or one of 16 custom-defined colors: 
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Figure 4.10 
Color selection 


Double-clicking on the 
application client area brings 
up the color selection dialog 
box, also. 


‘3 at: [133 | Green: [188 | 
Detine Custom Loluss... Color|Solid Lum: [114 | Blue: 


To define a custom color, click the Define Custom Color push 
button, and select a color from the color selection controls. Click 
on the Add to Custom Colors button. The custom color choice is 
added on the left of the dialog box. 


Select the desired color for the application background, and click 
the OK button. The color is applied. 


When you save a color palette, it’s only saved for the current 
session. 


Remove Window Colors 


Edit Resources 


Selecting Edit | Remove Window Colors removes the color 
selected with Edit | Window Colors. 


Edit | Edit Resources displays the following edit menu: 
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Figure 4.11 
Edit Application Window 
Caption 
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ProtoGen C++ Application Generator 
fit Application Tools Help 
Design Menu... Ctrl+M 
Main Window Dialog... 
Application Icon... 
Window Caption... 
Window Colors... 
Remove Window Colors 


File 


Edit Resources Resource... 


Source... 
Header... 
Make... 
Definition... 
Other... 


Edit | Edit Resources works with files less than 32K. It contains the 
following menu items: 

w Resource lets you bring up a .RC file for editing. 

m Source lets you edit .C or .CPP files. 

= Header lets you select .H files for editing. 

m Make lets you select .MAK files for editing. 

w Definition lets you select .DEF files for editing. 


w Other brings up a blank, untitled window, which can be used to 
edit text files. 
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DLG files 


Chapter 5, Dialog boxes 


Dialog boxes 


Dialog boxes are an important aspect of most business application 
development. Dialog box is a generic term for many kinds of input 
screens used in graphical user interface (GUI) environments. The 
main window of an application might actually be a dialog box, 
such as the Windows PIF Editor. A series of dialog boxes might 
cover the functionality of an entire application. In general, 
however, a dialog box is a window that contains entry fields and 
controls. You don’t have to link a dialog box to every menu item. 
Some menu items perform some function or bring up a submenu. 
When a dialog is attached to a menu item, the menu item should 
be displayed with an ellipsis, ”. . .”. The Open menu item on 
ProtoGen’s File menu is an example of such a menu item. 


This chapter discusses how to link dialog boxes to the 
application’s main window and to menus and push buttons. 


.DLG files, like .RC files, are text files. By convention .DLG files 
contain only dialog resources, although it’s possible for a .DLG file 
to hold other resources. .RC files usually contain various 
resources. ProtoGen assumes that .DLG files already exist in the 
working directory. If you don’t have .DLG files, create them with 
the Windows SDK or with another tool, such as Borland’s 
Resource Workshop. 
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The following steps create a .DLG file with Resource Workshop: 


1. Invoke Resource Workshop. 
2. Select File | New project. 
3. Set the program file type equal to RC. 
Resource Workshop displays an untitled RC dialog box. 
4. Select Resource | New 
5. Set the resource type equal to dialog. 
Resource Workshop displays a dialog editing box. 
6. Create the dialog box. 
7. Save the file as a .DLG file by setting file type equal to DLG. 


~~. Ifyou change a .DLG file in Resource Workshop or with another 
Vv tool after linking it to a ProtoGen application, the link is 
invalidated and error messages are displayed when you try to 
generate or compile the application. 


Although it’s unusual to have a .RC file that contains definitions 
of dialog boxes, if you have such a file, copy it and rename it with 
a .DLG extension. With a .DLG extension, ProtoGen can access 
dialog box definitions and link the dialog boxes to menu items. 


ProtoGen helps you link dialog boxes described in .DLG files to 
both menus and push buttons. 


Linking dialog boxes to menu items 


' 


Perform the following steps to link a dialog box to a menu item: 


1. Exit the Menu Designer to display the main ProtoGen screen. 


2. Select a menu item from a prototype menu (Design Menu in 
previous figures), which is displayed under “Application 
Caption”. 


The following Add Application Dialog screen is displayed if a 
dialog box isn’t already linked to the selected menu item. 
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Figure 5.1 
Add Application Dialog 


Chapter 5, Dialog boxes 


= Add Application Dialog 


Current Dialog: 


Files in: ¢:\protogen 
Dialog Files 


The Add Application Dialog buttons perform the following 
functions: 


w Remove isn’t applicable. See Edit Application Dialog. 

= Open File displays dialog resources contained in a .DLG file. 
After selecting a file, DIALOG templates contained in the file 
are listed in the lower right window for selection. 


m View Dialog displays the graphic dialog box represented by 
text in the .DLG file. 


m Dialog Mode sets the dialog box to be either modal or 
modeless. 


Radio buttons Modal and Modeless make the dialog box either 
modal or modeless. 


e Most dialog boxes are modal, which means the user can’t 
access other parts of the application until the dialog is 
finished. The modal dialog almost always offers at least two 
choices, OK or Cancel, for terminating the window. 


e A modeless dialog lets the user switch to other applications 
that are running. A modeless dialog doesn’t limit the user to 
other parts of the application. A modeless dialog resembles a 
popup window, except it contains entry fields and controls 
that gather or display information. 
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One .DLG linked 
to multiple menus 


Step-by-step 
linking 


You can’t link a .DLG file to more than one menu item unless you 
rename the file, creating a unique name for each additional link. 


To link dialog boxes in the .DLG files to a menu item, perform the 
following steps: 


1. 
2: 


Select Open File from the Add Application Dialog. 


Select the .DLG file you want to link to the menu item from 
the Dialog Files window of the Add Application Dialog Dialog 
box. The Dialogs Contained window shows contents of the 
.DLG file. 


. Click the View button to inspect the contents of the .DLG file. 
. Change the modality of the dialog box by selecting the dialog 


mode to be modal or modeless. 


. Click OK to link the file. 


Unlinking dialog boxes from menu items 


Figure 5.2 
Edit Application Dialog 
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To display the following Edit Application Dialog box press F2 or 
right-click the mouse when a dialog box is onscreen. 


Edit Application Dialog 


Current Dialog: 
demo.dig(DLG_PREFERENCES) 


Dialog Mode 


Files in: ¢:\protogen 
Dialog Files 
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Remove 


The buttons and list boxes on the Edit Application Dialog are like 
those on the Add Application Dialog, previously described, 
except Remove unlinks a menu item in a .DLG file from the 
application. 


To remove a link to a dialog box from an application, perform the 
following steps: 


1. Click on the menu item that the dialog box is attached to. 


2. Navigate to the dialog box by clicking on the menu items and 
the buttons containing subdialog boxes, until ProtoGen 
displays the dialog box you want to remove. 


3. Right click the mouse or press the F2 function key to bring up 
the Edit Application Dialog screen. 


4. Click on Remove and click OK to confirm. 


The dialog box is unlinked. 


Linking nested 


dialog boxes A nested dialog or subdialog is a modal dialog initiated from a 
parent dialog. The nested dialog gets information related to an 
element of the parent dialog. The nested dialog might call a 
second or third dialog to get more information or display data. 
ProtoGen lets you link a long tree of child dialog boxes. The 
following figure shows a nested dialog: 
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Figure 5.3 
Nested dialog boxes 


ProtoGen lets you attach 

subdialogs to push button 
controls on parent dialog 

boxes. 


Figure 5.4 
Edit Application Dialog 
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=| Control Panel a 
Settings Help 

Installed Printers: | 

Printers - Configure iim 

| : [2 Active | 


[= PostScript Printer on LPT1: 


4) Printer: QMS-PS 800 Plus EB | OK : 
Paper Souce: [Upper Tay __——*diF 
Paper Size: [Letter 8 % x 11 in E 


Orientation 


) © Portrait 
© Landscape 


Copies: fi | 


D0 Use Color 


Subdialogs are attached by clicking on push buttons within other 
dialog boxes, and following the steps for linking a dialog box toa 
menu item. 


= Edit Application Dialog 

Current Dialog: 

demo.dig{(DLG_PREFERENCES) 
Dialog Mode 
® 


© Modeless 


Files in: ¢:\protogen 
Dialog Files 
benefits.dlg 


ProtoGen displays the Edit Application Dialog screen from a 
previously linked dialog box or from the Add Application Dialog 
screen when you press F2 or when you right click the mouse. 
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If a dialog box is already linked to the menu item, its name is 
displayed in the Current Dialog window. 


Escaping from dialog box add or edit mode 


Sometimes it’s hard to remember how to escape from the dialog 
box editing mode. After you select a noncascaded menu, get the 
Add Application Dialog on the screen, and fill it in. The linked 
dialog box is displayed, usually with OK or CANCEL buttons. 


~)<- Clicking OK or CANCEL on the prototype tells ProtoGen you 
wv, want to add another dialog box instead of putting away the 
linked dialog box. Double-click on the client area of the user- 
defined dialog box to exit add or edit dialog box mode. 


Linking dialog boxes to the main window 


The main ProtoGen window’s Edit menu selection, Main Window 
Dialog, takes dialog boxes you've designed and puts them in the 
main window of your application. When the standard Windows 
main menu isn’t suitable for an application, a dialog box that 
fulfills the special requirements can be linked as a substitute for 
the Windows main menu. 


To add a dialog box to the main window of your application, 
perform the following steps: 


1. Select Edit | Main Window Dialog. The following dialog box 


is displayed: | 
Figure 5.5 
Main Window Dialog 


= 
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2. Click the Select button to display Add Application Dialog if a 
dialog box isn’t linked, or right-click to display the Edit 
Application dialog if one is already linked. 


Choose a dialog file from a list of .DLG files in the current 
working directory, navigate to other directories and select a 
file, or type in the name of the file in the Dialog Name 
window. 

3. Press the OK button. 
If a dialog box is attached to the application main window, the 
file name appears in the Dialog Name window. When the 
Select button is chosen, .DLG files located in other directories 
are copied to the working directory. 

4, Click OK to link the dialog box in the .DLG file to the 
application main window, or click Remove to unlink the 
dialog box from the window. 
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Figure 6.1 
Application menu 


Test 


Application menu 


This chapter discusses menu selections on the following 


Application menu, which lets you test and turn your prototype 
application into source code. 


Application 
Test 


Generate... Ctrl+G 
Compile... 
Execute... 


The Application menu items perform the following functions: 
= Test lets you exercise your application interactively. 
m Generate creates source code for your application. 


a Compile prepares and links code, producing an executable file 
with symbolic debugging codes if specified. 


m Execute runs the program under DOS. 
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To get the look and feel of an application, ProtoGen’s prototype is 
run in test mode. To place the application in test mode, choose 
Select Application | Test. The ProtoGen main window and main 
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Generate 


Figure 6.2 
Set Compiler Options 


Static Linking is grayed out in 
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ANSI mode. 


menu disappear, displaying the application alone. ProtoGen 
displays dialog and subdialog boxes when appropriate menu 
items are selected, but the application icon isn’t displayed in test 
mode. Testing your application in this manner ensures that the 
screen flow accomplishes your objectives. 


Either right-click the mouse or press F4 to terminate testing. The 
ProtoGen main window and main menu reappear. 


Accelerator keys don’t work in test mode. 


Before attempting to generate code, check File | Header and 
ensure that ProtoGen knows where to find the application header 
file. 


Selecting Application | Generate displays the following dialog 
box: 


= Set Compiler Options 


Generate Options Memory Model oe 

| 
oO ANSI C Generation O Small 
@ Borland C++ Generation © Medium (Saee 


C1 Debugging Information ®@ Large 
KX] Use Borland Controls 


D Static Linking 


Additional Libraries: 


Include Directory: |c:\borlandc\include:c:\protogen 
Library Directory: |c:\borlande\lib;c:\protogen 


For use with Borland C++, enter the following include directories 
to be searched. Type the semicolons, but not the carriage returns: 


w Drive:\BORLANDC\OWL\INCLUDE; 

mw Drive:\BORLANDC\CLASSLIB\INCLUDE; 

g Drive:\BORLANDC\INCLUDE 
Enter the following lib directories to be searched: 


w Drive:\BORLANDC\OWL\LIB; 
w Drive:\:BORLANDC\CLASSLIB\LIB; 
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a Drive:\BORLANDC\LIB 


Generate 


Options The functions performed by the Generate Options window are 
described in the following sections. 


ANSI C Generation This option creates ANSI C standard source code. One primary 
application source file is generated that takes the name of the 
application itself. This module contains the WinMain function and 
the window procedure for the application’s main window. 


The main window procedure contains function calls for each of 
the dialog boxes attached to menu items. The dialog functions 
reside in separate source files, named for the dialog they display, 
and they’re linked together in the link file. 


Any subdialog boxes attached are generated as individual source 
modules called from the window procedure of the dialog they’re 
attached to. 


Header information for the menu #define preprocessor directives 
and all dialog and subdialog boxes is stored in the application 
header file. 


If you’re using Turbo C++ for Windows, you can’t use the 
compile option to compile the application directly from ProtoGen, 
because Turbo C++ doesn’t include a command-line compiler or 
resource compiler. To compile your application, you must take the 
following steps: 


1. Select Application | Generate to create the necessary source 
code, header, resource, and project files. 


2. Start Resource Workshop, open your application’s .RC 
resource file, and save it as a .RES file. 


3. Start Turbo C++ for Windows, open your applications project 
(.PRJ) file, and select Make from the Compile menu. Your 
application is compiled. 


Borland C++ This option generates code for the Borland ObjectWindows C++ 
Generation _ library. 


Debugging Information This option places the necessary switches into the application 
makefile to include debugging information in the executable file. 
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Use Borland Controls 


Static Linking 


After finishing the prototype of your application, ProtoGen 
generates the code for it. The generated code includes a main 
source module (APPNAME.C or APPNAME.CPP) for the 
application’s main window, a source module (DLGNAME.C) for 
each dialog that is linked to the application if ANSI C code has 
been generated, a header file (.H) containing field #define 
preprocessor directives and variables where these have been 
provided, a resource file (.RC) a definition file (DEF), a makefile 
(.MAK), and a link file (.LNK) file. These files comprise the 
complete source and support files necessary to build the 
application into a stand-alone executable. 


The Borland Controls check box generates code to initialize and 
load the Borland dynamic link library, called BWCC.DLL. This 
DLL contains custom controls that give Borland dialog boxes and 
screens a sophisticated three-dimensional appearance. 


If you’re generating code for ObjectWindows, statically link it by 
clicking the Static Linking check box, which creates an executable 
file that contains the ObjectWindows library as opposed to a 
standard application working in conjunction with the Object- 
Windows DLL. If you’re generating code with the Borland Object- 
Windows library without static linking, you can generate code 
only for the Large memory model. ProtoGen selectively enables 
and disables some of these options according to the type of code 
generation specified. 


Once you choose the options from the Generate Options window, 
click the Generate button. ProtoGen outputs code to the various 
files needed for compiling programs. The modules are structured 
in the following way: 


w C++ code for ObjectWindows is generated as a single .CPP 
source file. Application class and main window class 
declarations appear first, followed by class and constructor 
declarations for each dialog box in the application. 


= The application class is a descendant of TApplication. The main 
window is a descendant of TWindow unless the main window 
is a dialog, in which case it is declared as a descendant of 
TDialog. Each dialog class is a descendant of TDialog. Message 
response member functions are declared for each message that 
invokes a dialog or subdialog. 
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m Next the member functions for the dialog boxes themselves are 
generated. The purpose of the dialog member functions is to 
invoke subdialog boxes attached via the dynamic dispatch table 
routing messages. 

uw Other member functions can be added to the dialog classes by 
inserting code between the regeneration brackets provided. The 
following excerpt from source code shows an example of these 


brackets: 


class TBENEFITSDlg : public TDialog 


{ 
public: 
TBENEFITSD1g(PTWindowsObject AParent, LPSTR AName) ; 
virtual void Ok(RTMessage Msg) = [ID FIRST + IDOK]; 
//REGEN BENEFITS ROUTING 
//REGEN_BENEFITS ROUTING 


i 
The brackets are //REGEN BENEFITS ROUTING. 


Compile 


Once the menu and screen flow has been set up and the code 
generated, compile the resulting application from within Proto- 
Gen by performing the following steps: 


1. Click on Application | Compile from the ProtoGen menu to 
display the following dialog box: 


= Application Compile 


DOS Command: 


Make. pif -fdemo.ma 


2. Enter the DOS command for compiling in your environment. 


3. Click the OK button. 


Figure 6.3 
Compile dialog box 


ProtoGen submits the command line to DOS for execution. If your 
system doesn’t have enough memory or if your Windows PIF 
Editor settings for COMMAND.COM are not set high enough for 
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memory requirements, you might not be able to load and 
complete the compilation. In general, 2-3MB is the amount of 
memory needed to compile an application. If you don’t have the 
necessary memory, exit Windows to carry out the compilation 
process. 


Execute 


Once the example application has been compiled, run it from 
within ProtoGen by performing the following steps: 


1. Choose Application | Run from the ProtoGen main menu. The 
following dialog box is displayed: 


Figure 6.4 Execute Application 


Execute dialog box 


2. Type in the file name to run. 
3. Click the OK button to execute the application. 


ProtoGen minimizes itself while the application runs. 
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Tools and other topics 


This chapter covers the Tools menu and miscellaneous topics. 


Selecting Tools from ProtoGen’s main menu displays one menu 
item, Define Tool. Tools lets you shell out to a selected Windows 
program from ProtoGen. 


Selecting Define Tool displays the following dialog box: 


= Update Tools Menu 


Menu Tools 


Figure 7.1 
Update Tools Menu 


Current programs on the Tools menu are displayed in the Menu 
Tools window. To add or delete programs from the Tools menu, 
fill in the dialog box according to the following procedure: 


1. Enter the full (absolute) path and name of a Windows 
program, such as Borland’s Resource Workshop, in the Path 
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Name window either by typing it or by pressing Select to see a 
list of windows executables and choosing one of the files. 


2. If you're adding instead of removing a program to the Tools 
menu, enter a title to be displayed on ProtoGen’s Tool menu as 
a menu item for shelling out to the program entered in step 1. 
If you’re removing a program, use the Select button to select it, 
or type in the path and name for the program. 


3. Click OK to add the program to the Tools list or Remove to 
remove it. 


Hints on using ProtoGen 


ProtoGen lets you make the following kinds of modifications to 
an application: 


w application flow 
w link dialog boxes created previously with a resource editor 
w changes to the application source code directly 


To alter application flow add, insert, or delete menu items and 
dialog boxes to the application by opening the .PVA in ProtoGen, 
interactively performing redesign work, and rebuilding the 
application source code. 


If you only want to make a change to a single dialog, you can use 
Borland’s Resource Workshop or ProtoView’s ViewPaint to edit 
-DLG files, then recompile the application resources. 


The third type of modification involves making source code 
changes. These changes can occur anywhere within the specially 
placed code-regeneration brackets provided in the source files. 
When code is placed in these areas it is preserved by ProtoGen 
from one code generation to the next. 


Although .PVA files are in ASCII format and can be edited, it is 
best to make changes only through ProtoGen. 
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